5.1.2 모든 지갑으로 디지털 화폐 인출 생성(가맹점이 정의한 환율)

#간단한 설명: 지갑의 출금 비즈니스 인터페이스로 디지털 화폐를 출금하여 사용자가 지정된 지갑 주소로 usdt를 전송할 수 있도록 합니다. (판매자가 정의한 환율을 설정하려면 판매자 백엔드에 로그인해야 함)

요청방법 : POST
요청 인터페이스: https://gateway-domain/wallet-trade-merchant/v1/pay/blockchain/custom/rate/create
요청 미디어 유형(JSON 데이터 형식)Content-Type: application/json

요청 매개변수

매개변수 이름	유형	필수	매개변수 의미	매개변수 설명
`key`	`string`	예	판매자 키	API키
`localOrderId`	`string`	예	판매자 플랫폼 현지 주문 번호	판매자 플랫폼은 로컬에서 고유한 주문 번호를 생성합니다
`localUserId`	`string`	아니요	판매자 플랫폼 로컬 사용자 ID	판매자 플랫폼 로컬 사용자 ID
`notifyUrl`	`string`	아니요	콜백 주소	주문 성공 후 API 콜백 요청을 통해 가맹점 주소로 안내됩니다. (콜백 내용은 하단 참조)
`successRedirectUrl`	`string`	아니요	주소	성공 후 해당 주소로 자동 점프
`currency`	`string`	예	통화	주문 통화
`network`	`string`	예	메인넷	메인넷(현재 TRON, BSC, POLYGON, ETHEREUM만 지원)
`address`	`string`	예	출금주소	출금주소
`quoteCurrency`	`string`	예	견적 통화 주문	견적 통화 주문(견적 통화 환율을 설정하려면 판매자 백엔드에 로그인해야 함)
`quoteAmount`	`string`	예	견적 금액	견적 금액
`isBlockchain`	`boolean`	아니요	블록체인 정보 반환 여부(기본값 false)	true인 경우 콜백 요청은 주문 체인에 거래 정보를 전달합니다
`expireSecond`	`Long`	아니요	만료 타임스탬프(초)
`sign`	`string`	예	서명	자세한 내용은 서명 알고리즘을 참조하세요.

json 샘플 요청

{
  "key": "9yUreYgTRtit39Dy",
  "localOrderId":"conantest0128",
  "localUserId":"996",
  "currency":"USDT",
  "network":"TRON",
  "address":"TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
  "quoteCurrency":"CNY",
  "quoteAmount":"20",
  "sign":"f0ef4f925b899734727b77975ff9c0a3"
}

응답 JSON 예시

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
     "orderId": 473228783386885,
     "localUserId": "996",
     "localOrderId": "conantest0128",
     "orderType": "WITHDRAW",
     "orderBizType": "WITHDRAW_ANY_DIGITAL_WALLET",
     "targetType": "EXTERNAL",
     "network": "TRON",
     "address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
     "currency": "CNY",
     "userCurrency": "USDT",
     "amount": "20",
     "userAmount": "20",
     "userReceivableAmount": "20",
     "rate": "1",
     "rateExpression": "1USDT≈1CNY"
     }
}

응답 데이터 매개변수 설명

매개변수 이름	유형	매개변수 의미	비고
`orderId`	`string`	주문번호
`localUserId`	`string`	판매자 로컬 사용자 ID
`localOrderId`	`string`	판매자 지역 주문 번호
`orderType`	`enum`	주문 유형	`PAYMENT：支付订单 \| WITHDRAW：提款订单`
`orderBizType`	`enum`	주문업종	orderBizType 유형 설명은 다음과 같습니다.
`targetType`	`enum`	대상 유형	targetType 유형 설명은 다음과 같습니다
`network`	`string`	메인넷 유형
`address`	`string`	주소	온체인 결제 주소
`currency`	`string`	통화 주문
`userCurrency`	`string`	도착통화
`amount`	`string`	주문금액
`userAmount`	`string`	사용자가 지불한 금액
`userReceivableAmount`	`string`	이용자 채권금액
`rate`	`string`	환율
`rateExpression`	`string`	환율 표현

orderBizType 유형 설명:

PAYMENT_WALLET_SCAN MINPAY 지갑 스캔코드 결제
PAYMENT_TRANSFER 디지털 화폐 바인딩 주소 직접 입금
PAYMENT_ANY_DIGITAL_SCAN QR 코드를 스캔하여 원하는 금액의 디지털 화폐를 결제하세요.
WITHDRAW_WALLET MINPAY 지갑으로 돈을 인출하세요.
WITHDRAW_ANY_DIGITAL_WALLET 디지털 통화를 지갑으로 인출하세요.
PAYMENT_FIXED_DIGITAL_SCAN 디지털화폐 한도금액 스캔코드 결제
BATCH_PAY 일괄결제

targetType 유형 설명:

INTERNAL 내부 주소
EXTERNAL 외부 주소
USER 사용자 추상 주소

콜백 세부정보

콜백 방법은 POST application/json입니다.

콜백 매개변수 JSON화 예시

{
"amount":"10",
"bizType":"WITHDRAW_ANY_DIGITAL_WALLET",
"currency":"CNY",
"extra":{
     "quoteAmount":"10",
     "quoteCurrency":"CNY",
     "quotePrice":"1"
        },
"localOrderId":"conantest0132",
"merchantActualAmount":"94.63",
"merchantCurrency":"CNY",
"merchantId":302992856974,
"merchantPaidAmount":"66.84",
"merchantUserId":"996",
"notifyTime":1772266852130,
"orderCreateTime":1772266745032,
"orderId":"473284157243653",
"status":"SUCCESS",
"type":"WITHDRAW",
"userAmount":"8.5",
"userCurrency":"USDT",
"userMinerFee":"1.5",
"userReceivableAmount":"10",
"sign":"78ef83b365e77c66b0cc3a283f8ebae4",
"key":"9yUreYgTRtit39Dy"
}

매개변수 이름	유형	참여 서명	매개변수 의미	매개변수 설명
`amount`	`decimal`	예	주문금액
`bizType`	`enum`	예	주문 유형	bizType 유형 설명은 다음과 같습니다.
`currency`	`String`	예	통화
`key`	`String`	예	판매자 키
`localOrderId`	`String`	예	지역 주문 번호
`merchantActualAmount`	`decimal`	예	가맹점 실제 결제금액
`merchantCurrency`	`String`	예	가맹점 결제통화	기본 통화
`merchantId`	`String`	예	판매자 ID
`merchantPaidAmount`	`decimal`	예	가맹점 결제금액
`merchantUserId`	`String`	예	사용자 ID
`notifyTime`	`long`	예	콜백 시간
`orderCreateTime`	`long`	예	주문 생성 시간
`orderId`	`String`	예	주문번호
`status`	`String`	예	결제현황
`type`	`String`	예	주문 유형	`PAYMENT:支付 WITHDRAW：提款`
`userAmount`	`decimal`	예	사용자 결제금액
`userCurrency`	`String`	예	사용자 결제 통화
`sign`	`String`	아니요	MD5 서명	자세한 내용은 서명 알고리즘을 참조하세요.
`extra`	`object`	예	다음 매개변수가 포함되어 있습니다.
└견적금액	`number`	예	주문 견적 금액
└quote통화	`number`	예	견적 통화 주문
└견적가격	`string`	예	견적 가격 주문
`userMinerFee`	`String`	예	채굴 수수료	출금 채굴 수수료
`userReceivableAmount`	`String`	예	이용자 채권금액	이용자 채권금액
`blockchain`	`object`	예	체인거래 정보	주문 요청 매개변수 isBlockchain이 true인 경우 콜백 요청은 이 객체 정보를 전달합니다. (온체인 트랜잭션만 관련된 경우 isBlockchain 매개변수가 적용됩니다.)
└네트워크	`String`	예	메인넷
└수신자주소	`String`	예	수신자 주소
└발신자주소	`decimal`	예	보내는 주소
└txID	`String`	예	거래 ID

bizType 유형 설명:

PAYMENT_WALLET_SCAN MINPAY 지갑 스캔코드 결제
PAYMENT_TRANSFER 디지털 화폐 바인딩 주소 직접 입금
PAYMENT_ANY_DIGITAL_SCAN QR 코드를 스캔하여 원하는 금액의 디지털 화폐를 결제하세요.
WITHDRAW_WALLET MINPAY 지갑으로 돈을 인출하세요.
WITHDRAW_ANY_DIGITAL_WALLET 디지털 통화를 지갑으로 인출하세요.
PAYMENT_FIXED_DIGITAL_SCAN 디지털화폐 한도금액 스캔코드 결제
BATCH_PAY 일괄결제

콜백 알림을 받으면 처리가 완료된 후 메시지가 성공적으로 수신 및 처리되었음을 나타내는 성공 문자열을 직접 반환해 주세요. 시스템이 성공 응답을 받은 후에는 더 이상 콜백을 반복적으로 보내지 않습니다. 예상된 응답을 받지 못한 경우(성공이 반환되지 않거나 예외가 반환됨) 시스템은 단계적 재시도 메커니즘에 따라 최대 14회 재시도하여 콜백 알림을 다시 보냅니다. 현재 재시도 간격은 다음과 같습니다. 15대, 15대, 30대, 180년대, 600년대, 1200년대, 1800년대, 1800년대, 1800년대, 3600년대, 10800년대, 10800년대, 21600년대, 21600년대

요청 매개변수​

json 샘플 요청​

응답 데이터 매개변수 설명​

orderBizType 유형 설명:​

targetType 유형 설명:​

콜백 세부정보​

콜백 방법은 POST application/json입니다.​

콜백 매개변수 JSON화 예시​

bizType 유형 설명:​